Performance Monitoring Overview

This section provides an overview of the device's performance monitoring feature.

The device measures performance at fixed sampling intervals of 15 minutes. The interval’s start time is synchronized with the device’s clock so that intervals begin on the hour (e.g., 12:00). For example, there will be an interval at 12:00, 12:15, 12:30, 12:45, 13:00, and so on. In addition to the current 15-minute interval, the device always stores a record of at least the last two completed intervals.

The device provides two main performance monitoring parameters - those that display real-time values measured in the latest interval and those that display historical measurements from passed, stored intervals. Most historical performance monitoring parameters provide statistical information from up to the last four stored intervals (i.e., an hour). However, some historical performance monitoring parameters provide statistical information from up to 100 stored intervals (i.e., 25 hours). Stored intervals are referred to as retention policy. Therefore, this allows you to retrieve measurements collected in a specific stored interval. Retrieving values from historical intervals is supported by the device's CLI, REST API, and SNMP. For more information, see Querying Historical Performance Monitoring Intervals and Values

You can access the performance monitoring parameters through the device's Web-based management interface, CLI, REST API, SNMP, or OVOC.

The hierarchical structure of this document represents the hierarchical structure (tree) of the device's performance monitoring parameters, as shown below:

■

Application: First (highest) tier in the hierarchical tree and represents the application to which the performance monitoring parameters belong (System, SBC, Media, Network, or Gateway).

■

Group: Second tier in the hierarchical tree and represents the group to which the performance monitoring parameters belong (e.g., System > licenseStats).

■

Element: Third (lowest) tier in the hierarchical tree and represents the subgroup to which the performance monitoring parameters belong. The actual performance monitoring parameters are located under this subgroup. Each performance monitoring typically has multiple elements (entities). For example, SBC call statistics has three entities -- "global", "IP Group", and "SRD"-- thereby providing three separate real-time performance monitoring parameters that measure the same thing, but per entity (all, IP Group , and SRD). If the Group level doesn't need subgroups for its performance monitoring parameters, only a single Element level is provided, which is called "global" (e.g., System > licenseStats > global > licenseFeuUsageAvg).

■

Performance Monitoring parameters: The performance monitoring parameters are located under the Element tier.

Throughout this document, each performance monitoring parameter provides a table with the following fields:

Field	Value
Parameter Name	Displays the general name of the performance monitoring parameter (e.g., cpuUtilizationAvg).
Type	Displays the type of performance monitoring parameter: ■ Gauge: A gauge indicates the current value of the monitored entity, which can fluctuate (increase or decrease) at any time, similar to a speedometer. Typically, performance monitoring parameters that provide minimum, maximum, or average values are gauges. ■ Counter: A counter is an integer that always increases in value (accumulative). The counter resets to zero (0) when it reaches a maximum number or when the device resets or powers off. The names of these performance monitoring parameters typically end with "Total" (e.g., mediaPacketsInTotal).
Calculation Type	Displays the calculation type: ■ Value: Indicates the number of currently established calls. A gauge or counter can have a value calculation type. The value is applicable only to real-time measurements. ■ Max: Indicates the maximum value during the 15-minute interval. This calculation type is applicable to real-time, gauge performance monitoring parameters. The names of performance monitoring parameters with this calculation type typically end with "Max" (e.g., mediaJitterInMax). ■ Min: Indicates the minimum value during the 15-minute interval. This calculation type is applicable to real-time, gauge performance monitoring parameters. The names of performance monitoring parameters with this calculation type typically end with "Min" (e.g., mediaJitterInMin). ■ Average: Indicates the average value during the 15-minute interval. This calculation type is applicable to real-time, gauge performance monitoring parameters. The names of performance monitoring parameters with this calculation type typically end with "Avg" (e.g., mediaJitterInAvg).
Realtime / History	Indicates if the performance monitoring parameter is one of the following: ■ Realtime: This indicates that it's a real-time performance monitoring parameter, which measures the current (real-time) value (total). For example, how many calls are currently active. ■ Historical: This indicates that it's a historical performance monitoring parameter, which displays the value of a specific, stored 15-minute interval. Historical measurements are based on real-time measurements.
Supported Platforms	Displays the supported SBC device models.
Retention Policy	Displays how many 15-minute sampling intervals are stored for the specific performance monitoring parameter. For example, a retention policy of 4 means that the sampling values of only the last four intervals are stored. Note: Only historical (not real-time) performance monitoring parameters have retention policies.
Web Name	Displays the name of the performance monitoring parameter in the Web interface (e.g., History/System/CPU Stats/CPU/CPU Utilization Avg).
CLI Name	Displays the name of the performance monitoring parameter in the CLI (e.g., show kpi interval (index) system cpustats cpu (index) cpuutilizationavg(index)(index)).
REST Name	Displays the name of the performance monitoring parameter in the REST API (e.g., /api/v1/kpi/history/system/cpuStats/cpu/(index)/cpuUtilizationAvg?interval=(index)(index)).
SNMP Name	Displays the name of the performance monitoring parameter the SNMP interface (e.g., acKpiSystemCpuStatsIntervalCpuCpuUtilizationAvg).
SNMP OID	Displays the SNMP OID (e.g., 1.3.6.1.4.1.5003.15.2.6.1.1.3).
Description	Provides a description (what it measures) of the performance monitoring parameter.